ICF /Alldisks Option
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
This option instructs ICF to include all drives in a file scan
operation.
This option may conflict with related options. The precedence order
for ICF options that control what drives are included in a file scan
operation are covered in the "ICF Drive Options Summary" topic.
See Also:  ICF Drive Options Summary, ICF File Scan Operations, ICF
/Drives Option, ICF /Skipdrives Option, ICF /Landrives Option, ICF
/Landriveso Option
ICF /Allext Option
This option specifies that all extensions should be totalled when the
/Totext option is given.
Note: This option is experimental and may be discontinued in future
versions of ICF.
See Also:  ICF Experimental Features, ICF /Totext Option
ICF /Append Option
If a data file is specified (with the DBASE, ASCII, or LOTUS options)
and a file already exists with the same name, use of this option will
result in data being appended to the existing file. If this option is
used and the doesn't already exist, it is created normally.
APPEND is not supported for files created with the LOTUS option.
See Also:  ICF /Overwrite Option, ICF /Dbase Option, ICF /Lotus
Option, ICF /Ascii Option
ICF /Ascii Option
This option instructs ICF to save data in an Ascii file. The file will
be comma delimited with quotes used to surround strings.
The extension applied to Ascii files is always .ASC. The name of the
file depends on other options that are set.
See Also:  ICF /Dbase Option, ICF /Lotus Option, ICF Output File
Naming
ICF /Ask Option
This option instructs ICF to present a data entry screen where
physical equipment and user identification data can be entered. This
screen is presented immediately prior to performing a configuration
collection via the STATUS or AUTO commands.
Note: Any data or changes entered WILL NOT be saved unless the
/Saveids option is specified.
By using the ASK command instead, the same data entry screen is
presented but a STATUS command is not performed. In this case /Saveids
does not have to be specified because all entered information is
automatically saved.
See Also:  ICF Collecting Physical Config Data, ICF /Saveids Option,
ICF Ask Command.
ICF /Attrs Option
The syntax of this option is
/Attrs=<file attribute codes>
This option specifies the file attributes files must have in order to
be included in file scan operations. The codes are as follows:
R   Readonly
S   System
H   Hidden
N   Normal
A   Archive
Examples
ICF FILES /ASCII /ATTRS=RS
See Also:  ICF /Protected Option, ICF File Scan Operations, ICF
/Normal Option
ICF /Autodays Option
The syntax for this option is:
/Autodays=<number of days>
This option specifies how many days can elapse before the STATUS
command is run to perform configuration data collection on the PC. It
is only valid when the AUTO command is used with ICF. Even if no other
changes are detected on a given PC, once this many days elapse since
the last time config data was collected a new run is performed.
For example,
ICF AUTO /AUTODAYS=14
will instruct ICF to perform the STATUS command every 14 days.
See Also:  ICF Auto Command, ICF /Autorun Option, ICF /Autoid Option,
ICF /Autorunfile Option, ICF /Autospace Option, ICF /Force Option
ICF /Autorun Option
/Autorun=<criteria codes>
This option specifies a list of criteria to check when ICF compares a
current configuration with a previous one, to determine if it is
necessary to perform another configuration data collection. It is only
valid when the AUTO command is used with ICF. If this option is not
specified, then all criteria is checked. The list of criteria codes is
formed by stringing together codes from the list below. Either the
long code or short code can be used (mixtures are ok) and each must be
separated from the next with a comma.
Long    Short
Code    Code    Description
CMOS    C       Cmos information
BIOS    B       Bios data
SPACE   S       Amount of free disk space on drives
MAIN    M       General information including memory, CPU
DIRS    D       Number of root-level directories
DAYS    Y       Number of days since last run
IDS     I       ID information entered manually
MCA     A       Installed microchannel boards
The CMOS, BIOS, MAIN, and MCA categories should be self-explantory (we
hope!).
The SPACE criteria checks if the amount of free disk space has changed
since the last configuration. Every local drive is compared with
results stored from the previous collection. By default a change of 2
MB of free space indicates that a new configuration should be
captured. This can be changed with the /Autospace option.
The DIRS criteria checks if the number of directories has changed on
each local drive. Only the directories immediately under the root
directory are counted. The addition or deletion of directories may
mean that a software package was added or deleted.
The IDS criteria compares manually-entered ID and physical component
information with previously stored data. This information is entered
when the /Ask option or Ask command are used.
See Also:  ICF Auto Command, ICF /Autodays Option, ICF /Autoid Option,
ICF /Autorunfile Option, ICF /Autospace Option, ICF /Force Option, ICF
/Ask Option, ICF Ask Command
ICF /Autorunfile Option
/Autorunfile=<file specification including path>
The AUTO command checks to see if any changes were made to the PC and,
if so, a STATUS command is automatically performed. In order to
compare the current configuration with a historical one, ICF saves
configuration information in a file on the local PC. While ICF can
check shared databases for configuration information, local files are
used because:
-   it does not rely on a shared database being available during
certain periods of time.
-   accessing a local file is faster, considering that network
traffic is avoided as well as time looking up data in an
indexed database.
-   this method works on standalone PC's as well as networked
PC's.
By default, ICF stores the configuration information in a file called
C:\AUTORUN.DAT. This option changes the name and path to whatever is
specified.  If the workstation is a disk workstation, or it is not
desired to place this file on a local drive, then this option can be
used to redirect the file to another drive/directory (i.e. a user's
private directory on a network).
See Also:  ICF Auto Command, ICF /Autodays Option, ICF /Autorun
Option, ICF /Autoid Option, ICF /Autospace Option, ICF /Force Option
ICF /Autospace Option
/Autospace=<bytes in K units>
This option specifies how much the amount of free disk space should
change before ICF performs a STATUS command to collect configuration
information on the PC. It is only valid when the AUTO command is used
with ICF.
If this option is not specified then the default of 2 MB is used. By
experimenting with this value you can guess when software programs may
have been added or deleted to the PC based on the assumption that the
amount of free diskspace would change considerably. This is of course
an assumption only, as in some cases the change could be the result of
data added or deleted, hard disk maintenance being performed, etc.
Every local drive is checked for free space and compared with results
from a previous run. Obviously if drives are changed, added or removed
then a change will likely occur.
Note that the number specified is in K units. In the following
example:
ICF AUTO /AUTOSPACE=4000
ICF will perform the STATUS command if the amount of free disk space
increased or decreased by 4,000,000 bytes since the last time it was
run.
Option, ICF /Autoid Option, ICF /Autorunfile Option, ICF /Force Option
ICF /Banner Option
This option specifies an optional "banner line" to be displayed after
the ICF program identification line when ICF is run. It can be used to
display your company name or other pertinent information.
In order to make it easy to specify values with embedded spaces, the
'_' (underscore) character is considered a substitute for spaces. ICF
will automatically filter these out and replace them with spaces.
Example
ICF /BANNER=THE_INVENTORY_COMPANY
would produce the banner line to be displayed as...
"THE INVENTORY COMPANY"
The default space character of '_' can be changed by using the
SPACECHAR option.
See Also:  ICF /Spacechar Option
ICF /Batch Option
This option is a Shortcut Option. It automatically specifies the
following options:
/Quiet
/Noreadmsg
/Overwrite
/Hide
/Filetype=Dbase
In other words, by including the /Batch option ICF will assume all the
above options.
See Also:  ICF /Quiet Option, ICF /Noreadmsg Option, ICF /Overwrite
Option, ICF /Hide Option, ICF /Filetype Option, ICF Shortcut Options
ICF /Bigfiles Option
This option specifies that only "big files" are processed in a file
scan operation. A big file is defined as a file whose size is greater
than that specified by the BIGFILESIZE option. If the BIGFILESIZE
option isn't included, the default size of 500,000 bytes is used.
See Also:  ICF File Scan Operations, ICF Smallfilesize Option, ICF
Bigfilesize Option, ICF Smallfiles Option, ICF Size Option
ICF /Bigfilesize Option
This option specifies the file size, in bytes, used for comparison
when the BIGFILES option is included. Unless this option is used, ICF
uses a default size of 500,000 bytes.
Bigfiles Option, ICF Smallfiles Option, ICF Size Option
ICF /Break Option
/Break=N | Q
This option controls the processing of any Ctrl-Break keypresses
during ICF operation. If Ctrl-Break is hit during an ICF run, the
following processing occurs depending on the use of the BREAK option:
If /Break=N
It is ignored and processing continues.
If /Break=Q
Processing is immediately aborted.
If /Break is not given as an option
ICF asks if processing should be aborted. Hit N or Y to answer.
ICF /BREAK=N
ICF /BREAK=Q
See Also:  ICF /Escape Option
ICF /Cls Option
This option instructs ICF to clear the screen before starting any
other operation.
ICF /Companyname Option
/Companyname=<string>
This option specifies a user-defined name to represent the company. It
is valid only for the Status command. The value entered for this
option will be saved in a special "ID" field just like any other item
of information captured from the computer ICF is running on. See the
"ICF ID Fields" Help Topic for more information.
See Also:  ICF ID Fields, ICF /Computerid Option, ICF /Miscid1 Option,
ICF /Miscid2 Option, ICF /Modemid Option, ICF /Monitorid Option, ICF
/Printerid Option,  ICF /Userid Option, ICF /Username Option, ICF
/Computername Option
ICF /Computerid Option
/Computerid=<string>
This option specifies a user-defined "tag" or ID to represent the
computer that ICF is running on.  The value entered for this option
will be saved in a special "ID" field just like any other item of
information captured from the computer ICF is running on. See the "ICF
ID Fields" Help Topic for more information.
See Also:  ICF ID Fields, ICF /Miscid1 Option, ICF /Miscid2 Option,
ICF /Modemid Option, ICF /Monitorid Option, ICF /Printerid Option,
ICF /Userid Option, ICF /Username Option, ICF /Computername Option,
ICF /Dbase Option
This option instructs ICF to save data in a Dbase III file. The file
will be able to be read by any software program that understands .DBF
type files.
The extension applied to Ascii files is always .DBF. The name of the
Hint: While some packages may not directly support Dbase files, they
may have inport conversion commands or utilities to convert such files
into their native format (i.e. Paradox).
See Also:  ICF /Ascii Option, ICF /Lotus Option, ICF Output File
ICF /Desc Option
This option specifies that additional "description" fields are to be
added to each record in the output file. It has a unique use for each
of the several ICF commands affected by this option. The /Desc option
is ignored for commands that do not have "description" fields.
The following commands are supported by this option:
STATUS
LANACCESS
LANSERVERS
LANRESOURCE
LANERRORS
See Also:  ICF Status Command
ICF /Descend Option
ICF will descend a directory tree and process all nested
subdirectories starting with the first one specified if this option is
used. Since this is the default behaviour, /Descend is used only to
override a previously issued /Nodescend option.
See Also:  ICF /Nodescend Option
ICF /Domains Option
This option is reserved for LAN vendor-specific versions of ICF.
See Also:  ICF Options Summary
ICF /Drives Option
/Skipdrives Option, ICF /Landrives Option, ICF /Landriveso Option, ICF
/Alldisks Option
ICF /Entiredisk Option
There are many options that set "filters" to be used when performing a
file scan command. The result of these filters is that only files that
meet the specified criteria are included in the output. Files can be
selected based on file size, file date, file attributes, and names.
This option instructs ICF to override all these options, in effect
skipping any filter conditions previously defined. All files will be
included in a file scan operation.
See Also:  ICF /Bigfiles Option, ICF /Smallfiles Option
ICF /Escape Option
This option instructs ICF to abort processing if the ESC (escape) key
is hit. If it is not specified then hitting ESC key has no effect.
It may be useful to include /Escape to permit users to abort
processing in case more important (in the eyes of the user) work needs
to be done.
See Also:  ICF /Break Option
ICF /Filename Option
/Filename=<filespec> or
$TEMP     or
$COMPID   or
$USERID   or
$USERNAME
This option specifies the name of the output file created when one of
the output file options is used: /Dbase, /Ascii, and /Lotus. Normally
ICF assigns a default name to an output file, which depends on the
command ICF is performing. Refer to "ICF Output File Naming" for
complete information.
If the /Filename option is used, a different file name is assigned
depending on the parameter used:
<filespec>
Specifies a file name, which may include a drive/path
specification. Note that the location of the output file is also
affected by the /Outdir option.
$TEMP
The file name is assigned a unique number padded with zeroes. ICF
makes sure the name assigned does not conflict with existing file
names in the same output directory. The first file name would be
ICF00001.DBF, the second ICF00002.DBF, and so on.
$COMPID
The file name is assigned the first eight characters from the
value specified on the /Computerid option.
$USERID
value specified on the /Userid option.
value specified on the /Username option.
Note: If the $COMPID, $USERID, or $USERNAME options are used, and the
corresponding option used to retrieve the name is not specified, an
error will result.
See Also:  ICF /Dbase Option, ICF /Ascii Option, ICF /Lotus Option,
ICF Output File Naming, ICF /Outdir Option, ICF /Computerid Option,
ICF /Userid Option, ICF /Username Option
ICF /Findexts Option
See Also:
ICF /Findextsval Option
ICF /Floppy Option
This option is a Shortcut Option - it automatically specifes the
/Outdir=A:\
/Needspace=50
/Filename=Temp
In other words, specifying just the /Floppy option instructs ICF to
send the output file to the A:\ drive and directory, use a file name
of "temp", and make sure at least 50,000 free bytes exist on the disk
before starting.
See Also:  ICF /Needspace Option, ICF /Outdir Option, ICF /Filename
Option, ICF Shortcut Options
ICF /Force Option
This option forces a configuration data collection to be performed
when the AUTO command is used. It instructs ICF to ignore the normal
criteria used to check if any changes were made to the configuration.
/Autodays Option
ICF /Forceglobal Option
/Entiredisk
/Alldisks
The effect is to search all files on all disks during a file scan
See Also:  ICF Shortcut Options, ICF /Entiredisk Option, ICF /Alldisks
Option
ICF /Hide Option
This option instructs ICF to "hide", or protect certain files that ICF
uses. When the AUTO command is used, this option will cause ICF to set
the Hidden, System, and Read-only attributes for the AUTORUN.DAT file
(note that the /Autorunfile option can change this file name).
Use of this option helps secure critical files from users. ICF will
always be able to read the file, but under normal circumstances it
will not be deleted, or even viewed in directory listings.
See Also:  ICF /Autorunfile Option, ICF Auto Command
ICF /Id Option
This option specifies that output files should have additional fields
added to each record to assist in identifying which configuration the
record belongs to. The fields added are:
Field       Type    Length
============================
Username     C        25
Miscid       C        25
Compid       C        25
The values for these fields are automatically filled in from the
/Username, /Miscid, and /Computerid options (shown in order
corresponding to the field order above).
See Also:  ICF Output File Structures, ICF /Timestamp Option, ICF
/Miscid Option, ICF /Compid Option, ICF /Username Option
ICF /Indir Option
This option specifies the input directory used for reading data files
during the inventory collection process. These files include
directories holding software and hardware recognition data.
By default ICF looks in the default directory for these files. If you
want to place them on a special directory then this option is needed
so ICF can find them.
Hint:  It may be prudent to place these files on a file server drive
in a network environment.
See Also:  ICF /Outdir Option
ICF /Ismca Option
This option forces ICF to perform Microchannel inventory collection on
machines that are not recognized as MCA (Micro Channel Architecture)
computers.
It is currently required on computers running any version of OS/2.
See Also:  ICF OS/2 Version
ICF /Landrives Option
This option specifies that LAN (network) drives should be included in
any file scan operation. By default ICF ignores LAN drives.
/Drives Option, ICF /Skipdrives Option, ICF /Landriveso Option, ICF
ICF /Landriveso Option
This option specifies that ICF search only LAN (network) drives during
any file scan operation. Local drives are ignored.
ICF /Lotus Option
This option instructs ICF to save data in an Lotus 1-2-3 file. The
file will  be able to be read in by any software package that reads
.WK1 spreadsheet files. Most spreadsheet and database programs are
capable of reading (or at least translating) these files.
The extension applied to files created with this option is always
.WK1. The name of the file depends on other options that are set.
NOTE:  The APPEND option is ignored if the LOTUS option is specified.
See Also:  ICF /Ascii Option, ICF /Dbase Option, ICF /Append Option
ICF /Miscid1 Option
/Miscid1=<string>
This option specifies a user-defined "tag" or ID to represent any
component of the computer. It is one of 2 "miscid" fields (the other
being /Miscid2). The value entered for this option will be saved in a
special "ID" field just like any other item of information captured
from the computer ICF is running on. See the "ICF ID Fields" Help
Topic for more information.
See Also:  ICF ID Fields, ICF /Computerid Option, ICF /Miscid2 Option,
ICF /Miscid2 Option
/Miscid2=<string>
being /Miscid1). The value entered for this option will be saved in a
ICF /Modemid Option
/Modemid=<string>
This option specifies a "tag" or ID to help identify a modem attached
to the computer. The value entered for this option will be saved in a
ICF /Miscid2 Option, ICF /Monitorid Option, ICF /Printerid Option,
ICF /Monitorid Option
/Monitorid=<string>
This option is used to specify a "tag" or ID used to identify a
monitor attached to the computer.  The value entered for this option
ICF /Miscid2 Option, ICF /Modemid Option, ICF /Printerid Option,  ICF
/Userid Option, ICF /Username Option, ICF /Computername Option, ICF
/Companyname Option
ICF /Needdir Option
/Needdir=<directory name>
This option instructs ICF to verify that the specified directory
exists before starting any processing. If the directory does not
exist, processing is aborted.
See Also:  ICF /Needfile Option, ICF /Needspace Option, ICF /Needdir
ICF /Needfile Option
/Needfile=<file name>
This option instructs ICF to verify that the specified file exists
before starting any processing. If the file does not exist, processing
is aborted.
See Also:  ICF /Needspace Option, ICF /Needdir Option
ICF /Needspace Option
/Needspace=<free space in K units>
This option instructs ICF to verify that at least the specified number
of bytes (in K units) of free disk space exist on a disk. If the
amount of space specified is less than that specified, processing is
aborted. The disk that space is checked on depends on whether or not
the /Outdir option is specified. If /Outdir is used and a drive letter
is included on the Outdir path, that is the disk that is checked.
Otherwise ICF checks the default disk.
Hint:  This option is especially valuable when saving data to a floppy
disk.
See Also:  ICF /Needfile Option, ICF /Needdir Option, ICF /Outdir
Option, ICF /Floppy Option
ICF /Noalignext Option
This option specifies that extensions should not be aligned when
displayed on the screen. It is only valid for the FILES command and
when output is not directed to a file. For example, without the
/Noalignext option the following display is produced from the command
(parts of the output have been omitted for readability):
ICF FILES D:\LLPRO
====================================
LE       EXE  34795 10-11-91 04:00 A
LE       HLP  45547 10-09-91 04:00 A
LLPRO    EXE 220810 10-11-91 04:00 A
LLPRO    ICO   1526 10-11-91 04:00 A
README   TXT  30760 10-11-91 04:00 A
and when the option is used:
ICF FILES D:\LLPRO /NOALIGNEXT
LE.EXE        34795 10-11-91 04:00 A
LE.HLP        45547 10-09-91 04:00 A
LLPRO.EXE    220810 10-11-91 04:00 A
LLPRO.ICO      1526 10-11-91 04:00 A
README.TXT    30760 10-11-91 04:00 A
See Also:  ICF Files Command
ICF /Nodescend Option
This option instructs ICF not to descend a directory tree during any
file scan operation. By default ICF processes all nested
subdirectories starting  with the first one specified.
See Also:  ICF /Descend Option, ICF File Scan Operations
ICF /Nofilesdefault Option
This option specifies that any file scan operation should require a
file specification to be given in the command line. Normally when a
command is given, such as
ICF FILES
it is assumed that all files on all drives should be scanned. If you
want to disable this behaviour and force the identificationof files
then use this option.
See Also:  ICF File Scan Operations
ICF /Nomsg Option
/Nomsg=<list of codes>
This option suppresses various messages from being displayed by ICF
while processing. It can be used to present a "cleaner" or more
turnkey display for users. The codes can be a combination of the
following:
R   Suppress messages displayed when an input file is read.
F   Suppress messages displayed when an output file is opened or
closed.
E   Suppress the "End of program run" message.
ICF STATUS /DBASE /NOMSG=FE
Suppress open/close and "End of program run" messages.
ICF FILES /NOMSG=R
Suppress "read input file" messages.
See Also:  ICF /Noreadmsg Option
ICF /Nonumber Option
If text files are output to the screen or printer (as a result of
using the STATUS command with appropriate options to capture files
such as Config.Sys and Autoexec.Bat), these files are normally
displayed with line numbers.
If this option is specified the line numbers are suppressed. It has no
effect if output is directed to a file with the ASCII, DBASE, LOTUS,
or FILETYPE options.
See Also:  ICF /Ascii Option, ICF /Dbase Option, ICF /Append Option,
ICF /Lotus Option, ICF Status Command
ICF /Noreadmsg Option
This option supresses ICF from displaying a status message when it
reads an input file. Normally ICF will display a message similar to
Loading data. Please wait...
when it reads an input file (an input file is any file that provides
ICF with data, such as the programs file or microchannel boards file).
If this option is used the message is not displayed.
The same effect is produced by using the NOMSG option with R.
ICF STATUS /NOREADMSG
ICF STATUS /NOMSG=R
(the above options produce the same result)
See Also:  ICF /Nomsg Option, ICF /Batch Option
ICF /Normal Option
This option specifies that only "normal" files are included in file
scan operations. A "normal" file is completely unprotected - it does
not have the System, Hidden, or Readonly attributes set.
See Also:  ICF /Protected Option, ICF /Attrs Option, ICF File Scan
Operations
ICF /Noshowdir Option
This option specifies that directory entries should not be included
while processing the ICF Files Command. Normally directory entries are
displayed with their name followed by the <DIR> indicator. This option
inhibits this display.
Note:  This option does not prevent subdirectories from being
processed. See the /Descend and /Nodescend options for related
information.
See Also:  ICF Files Command, ICF /Showdir Option, ICF /Descend
Option, ICF /Nodescend Option
ICF /Nostatus Option
ICF /Omitfiles Option
ICF /Outdir Option
This option specifies the directory used to store output files from
ICF. ICF will normally use the current default directory to place any
output files unless one of the following conditions occurs:
- The /Outdir option is used
- A path specification is included on the /Filename option.
See Also:  ICF /Indir Option, ICF /Filename Option, ICF Outdirnov
Option, ICF /Needspace Option, ICF Output File Naming
ICF /Outdirnov Option
This option instructs ICF to ignore any path specifications included
on the FILENAME option and always use the directory specified on the
OUTDIR option when located output files.
Normally if both the OUTDIR option is specified, and the FILENAME
option is used and includes a path specification, the FILENAME path
will override the OUTDIR path. The OUTDIRNOV option changes reverses
this behaviour.
See Also:  ICF /Outdir Option, ICF /Filename Option
ICF Overwrite Option
This option specifies that if an output file already exists with the
same name as the one being created, the old file is overwritten. By
default ICF will not overwrite files and will abort if such an attempt
is made.
See Also:  ICF /Append Option, ICF /Batch Option
ICF /Pause Option
ICF /Printerid Option
/Printerid=<string>
ICF /Miscid2 Option, ICF /Modemid Option, ICF /Monitorid Option,  ICF
ICF /Proginfo Option
ICF /Progslimit Option
ICF /Protected Option
This option specifies that only "protected" files should be included
in file scan operations. Protected files must have at least one of the
Hidden, System, and Readonly attributes set.
See Also:  ICF /Attrs Option, ICF File Scan Operations, ICF /Normal
ICF /Quiet Option
This option instructs ICF to suppress the display of all status
messages while running. It can be used to remove clutter from the
screen as a result of status messages being displayed.
See Also:  ICF /Noreadmsg Option, ICF /Nomsg Option
ICF /Recslimit Option
/Recslimit=<n>
This option instructs ICF to abort processing after <n> records have
been processed. It is useful for testing ICF runs.
See Also:  ICF /Recsnotify Option
ICF /Recsnotify Option
/Recsnotify=<n>
This option instructs ICF to display a progress message after every
<n> records processed. It is for testing and convenience so you know
work is actually being done (useful for commands or options that may
take a long time to perform).
See Also:  ICF /Recslimit Option
ICF /Saveids Option
ICF /Servers Option
This option is reserved for LAN specific versions of ICF.
ICF /Servertypes Option
ICF /Showdir Option
This option specifies that directory entries should be listed during
processing of the ICF Files command. Normally directory entries are
listed by name with the <DIR> indicator next to them. Since this is
the default behaviour, /Showdir is only necessary to override a
previously issued /Noshowdir option.
See Also:  ICF Files Command, ICF /Noshowdir Option
ICF /Size Option
The syntax of this option is:
/Size= L<n> | E<n> | G<n>
This option specifes what size, in bytes, to use in comparing file
sizes during a file scan operation, and what type of comparison is
made.
Examples:
/Size=L1000
Include all files whose file size is less (L) than 1,000 bytes
/Size=E140000
Include files whose size is equal to 140,000 bytes
/Size=G5000000
Include files whose size is greater than 5,000,000 bytes
Bigfiles Option, ICF Bigfilesize Option
ICF /Sizek Option
This option specifies that all file sizes should be displayed in
Kilobyte units. A 'K' will follow each file size to indicate this
option is set. By default ICF will display file sizes as exact
numbers, unless doing so would overflow the space available for
display. In such cases ICF will automatically convert the number to
Kilobyte or Megabyte units and append a 'K' or 'M' suffix as
appropriate.
This option only affects the ICF Files Command, and only if output is
sent to the screen or printer (i.e. output is not going to a file).
For example, when the /Sizek option is not specified as in the
and when it is specified:
ICF FILES D:\LLPRO SIZEK
LE       EXE    34K 10-11-91 04:00 A
LE       HLP    45K 10-09-91 04:00 A
LLPRO    EXE   220K 10-11-91 04:00 A
LLPRO    ICO     1K 10-11-91 04:00 A
README   TXT    30K 10-11-91 04:00 A
ICF /Skipdrives Option
ICF /SKIPDRIVES=<drive list>
where <drive list> is a string of letters, each representing a valid
disk drive. Colons and commas should not be included in the string
This option specifies drives that should be skipped during file scan
operations. This option may conflict with related options. The
precedence order for ICF options that control what drives are included
in a file scan operation are covered in the "ICF Drive Options
Summary" topic.
/Drives Option, ICF /Landrives Option, ICF /Landriveso Option, ICF
ICF /Smallfiles Option
This option specifies that only "small files" are processed in a file
scan operation. A small file is defined as a file whose size is less
than that specified by the SMALLFILESIZE option. If the SMALLFILESIZE
option isn't included, the default size of 100,000 bytes is used.
Bigfiles Option, ICF Bigfilesize Option, ICF Size Option
ICF /Smallfilesize Option
when the SMALLFILES option is included. Unless this option is used,
ICF uses a default size of 100,000 bytes.
See Also:  ICF File Scan Operations, ICF Bigfiles Option, ICF
ICF /Sorte Option
This option specifies that files should be sorted by extension first,
prior to displaying their names on the screen. It is only available
for the FILES command.
ICF /Spacechar Option
This option specifes the special character used to substitute for
spaces. It is used in conjunction with other options that may have
long text strings as their value. If this option isn't specified, the
'_' (underscore) character is used by default.
See Also:  ICF /Banner Option
ICF /Timestamp Option
added to each record to assist in identifying the exact date and time
the record was written. The added fields are:
Tsdate       D          8
Tstime       C          8
See Also:  ICF Output File Structures, ICF /Id Option
ICF /Totals Option
This option specifies that totals for each directory should be
displayed. It is only valid for the FILES command and when output is
sent to the screen or printer.
ICF /Totext Option
This option is used only with the FILES command, and is only valid
when output is sent to the screen. It specifies that file size and
count totals should be displayed by file extension. Not all extensions
are displayed -- only "popular" ones. If all extensions should be
totalled then include the /Allext option.
See Also:  ICF Experimental Features, ICF /Allext Option
ICF /Userid Option
/Userid=<string>
This option specifies a "tag" or ID to help identify the user that the
computer belongs to .  The value entered for this option will be saved
in a special "ID" field just like any other item of information
captured from the computer ICF is running on. See the "ICF ID Fields"
Help Topic for more information.
/Printerid Option, ICF /Username Option, ICF /Computername Option, ICF
ICF /Username Option
/Username=<string>
This option specifies the name of the user that the computer belongs
to. The value entered for this option will be saved in a special "ID"
field just like any other item of information captured from the
computer ICF is running on. See the "ICF ID Fields" Help Topic for
more information.
/Printerid Option,  ICF /Userid Option, ICF /Computername Option, ICF
ICF Ask Command
This command presents a screen in which you can enter stand-alone or
physical equipment to automatically be included in the configuration
analysis whenever the STATUS command is performed.
Unlike the /Ask option, using this command simply presents a data
entry screen for entering information and, upon exiting, immediately
exits ICF with no configuration run being performed.
See Also:  ICF Collecting Physical Config Data, ICF /Ask Option
ICF Auto Command
This command is used to check if any changes were made to a PC's
configuration since the last time configuration data was collected. If
changes are detected, ICF automatically performs the STATUS command
which will result in a new data collection.
This process has been carefully designed to permit ICF to quickly
perform a
"pre-check" of a computer configuration to determine if it's practical
to do a full configuration run. Since a full run could take time
(particularly if software packages are inventoried), this feature is
extremely powerful. It enables you to have ICF run every day on each
computer, and it will run very quickly unless it determines a full run
is required.
Following is a discussion of the events that take place when ICF is
used
with the Auto command. Refer to other mentioned topics and options for
details.
1.  If the /Force option is specified, further checking is not
performed and a configuration run is performed.
2.  ICF looks for a file on a local hard disk called C:\AUTORUN.DAT.
This file contains data saved during the last configuration run.
If the file is not found, ICF does a new run.
This file may have different names and/or locations, depending on
whether the /Autorunfile option is used. In addition, if the /Hide
option was previously used then the file may be marked as Hidden,
System, and Readonly.
3.  If the /Autorun option is not specified, ICF will use all the
criteria for comparing the current configuration with the previous
one. As soon as a change is detected ICF stops checking and starts
a configuration run. Following is the criteria that is checked:
For more information on these refer to the "ICF /Autorun Option".
4.  If the /Autorun option is specified, the it specifies to ICF the
criteria that should be checked. This would likely be a subset of
those shown above.
While configuration data is being collected, the /Escape option may be
used by the user to abort the run. This is useful if the user needs to
get on with pressing work and cannot wait for ICF to finish. If
/Escape is not specified then the user cannot abort (the /Break option
controls Ctrl-Break behaviour).
See Also:  ICF /Autodays Option, ICF /Autoid Option, ICF /Autorunfile
Option, ICF /Autospace Option, ICF /Autorun Option, ICF /Force Option,
ICF /Hide Option, ICF /Escape Option, ICF /Break Option
ICF Collecting Physical Config Data
ICF permits data to be manually entered in order to record information
representing physical/stand-alone equipment and user identification.
The data entry screen that records this information is presented
whenever the ASK command or /Ask option is specified.
-   The ASK command is used only to present the edit screen to enter
this information, and then exit ICF. Any changes made while
editing are automatically saved.
-   The /Ask option is used in conjunction with the STATUS or AUTO
commands, and results in the edit screen being presented, and then
a configuration run is performed (depending on other options
specified with the particular command given). Any changes made
while editing are NOT saved automatically -- the /Saveids option
must be specified for this to occur.
If changes are saved, they are stored in a special file normally
called C:\AUTORUN.DAT.  This file may be named differently or located
in a different drive/directory if the /Autorunfile option is used. If
you want to protect the file from deletion or editing, the /Hide
option will make the file as Hidden, System, and Read-only by setting
the appropriate DOS file attributes.
The following information can be entered:
User ID         ID of computer user
User Name       Name of computer user
Location        Can be room, company, floor, dept, etc.
Notes 1         Any notes
Notes 2         Any notes
1 to 8 equipment descriptions, each consisting of the following
fields:
Type            Typically P=Printer, M=Modem, C=Computer, etc.
Make            Brand of equipment
Model           Model description of equipment
Serial          Serial number of item
The following keys are available for use when editing this data:
TAB, SHIFT-TAB and ENTER
moves cursor between fields
Arrow keys
moves cursor between letters
Home, End
moves cursor to start / end of field
CTRL-W
saves entered information
ESC
aborts any changes made
See Also:  ICF /Ask Option, ICF Ask Command, ICF /Saveids Option, ICF
/Autorunfile Option, ICF /Hide Option
ICF Command Syntax
ICF is run from the DOS prompt and the syntax is as follows:
ICF <command> <command parameters> <options>
The <command> may be any valid command for ICF. The <command
parameters> are command-specific options that restrict ICF operation
to certain functions. <Options> is a list of options separated by
spaces. Options must be prefixed with the / or - characters.
List all files (directory information) on all drives. By
default ICF searches all files in all directories.
ICF FILES D:\SAMPLES /NODESCEND
The Files command operates only the included parameter
(d:\samples) and ICF will not descend directories.
See Also:  ICF Commands Summary, ICF Options Summary, ICF Options
Specification Methods
ICF Commands Summary
Following is a summary of ICF commands.
Command     Description
=======================================
Files       Gather information about specified files
Status      Gather status and inventory collection information
Auto        Automatic version of Status command
Programs    Gather program information
Diskspace   Collect statistics on disk space
Help        Display help on specified topics
See Also:  ICF Files Command, ICF Status Command, ICF Auto Command,
ICF Programs Command, ICF Diskspace Command, ICF Help Command
ICF Diskspace Command
This command instructs ICF to report disk space statistics on all
local drives in the system. LAN (remote) drives are included if the
/Landrives or /Landrives options are included.  If output is sent to
the screen, a report similar to the example shown below is produced:
======================================================================
DISK SPACE REPORT
----------------------------------------------------------------------
DRIVE  TOTAL SPACE      USED SPACE -- (pct)       FREE SPACE -- (pct)
C:     33,296,384       24,782,848   (74.4)         8,513,536   (25.6)
D:     88,485,888       87,330,816   (98.7)         1,155,072   (1.3)
E:     88,485,888       69,402,624   (78.4)        19,083,264   (21.6)
LOCAL 210,268,160      181,516,288   (86.3%)       28,751,872
(13.7%)
Output will be directed to a file if one of the file output options is
specified: /Dbase, /Ascii, and /Lotus.
See Also:  ICF Overview, ICF /Landrives Option, ICF /Landriveso
Option, ICF /Dbase Option, ICF /Lotus Option, ICF /Ascii Option
ICF Drive Options Summary
There are several options that control which disk drives are included
in any "file scan operation". File scan operations are performed by
the FILES, STATUS, and PROGRAMS command. Following is a summary of
each option. They are also listed in order of precedence (options at
the start of the list take precedence over options at the end of the
list)
Alldisks        Include all drives
Skipdrives      Specify drives to skip
Drives          Specify drives to include
Landrives       Include LAN drives
Landriveso      Include only LAN drives
See Also:  ICF /Skipdrives Option, ICF /Alldisks Option, ICF /Drives
Option, ICF /Landrives Option, ICF /Landriveso Option
ICF Environment Variable "ICF"
The ICF environment variable may be used to specify additional options
to ICF. Other methods for specifying options include using the command
line and writing ICF.INI files. To create this variable, use the DOS
or OS/2 SET command.
SET ICF=/Smallfilesize:100 /Bigfilesize:100000
SET ICF=/Batch /Floppy
Note:  When writing options that require a value, use the ':'
character as a separator rather than the '=' character. The SET
command will not like multiple ='s in a single line (you'll get an
error message).
See Also:  ICF Options Specification Methods, ICF Environment
Variables
ICF Environment Variable "ICFINI"
The ICFINI environment variable controls how ICF searches for ICF.INI
files. Following are the different values that can be assigned to
ICFINI.
NONE
Instructs ICF to avoid searching and reading any ICF.INI files.
NOLAN
Instructs ICF to avoid searching for ICF.INI files on LAN drives.
<pathname
If a '<' character is immediately followed by a valid pathname,
that path is searched for the ICF.INI file.
Example:
SET ICFINI=<T:\DEFAULTS
See Also:  ICF Environment Variables
ICF Environment Variables
ICF will look for and use any of several environment variables when
doing its work. These variables modify the behaviour of ICF during
certain operations.
To specify an environment variable, the DOS (or OS/2) SET command must
be used, either from the command line or a batch file. Refer to your
operating system manual for more information.
Following are environment variables that are used by ICF.
ICF
Use this variable to specify additional options for ICF to use.
ICFINI
Use this variable to specify how ICF searches for ICF.INI files
See Also:  ICF Environment Variable "ICF", ICF Environment Variable
"ICFINI", ICF Options Specification Methods
ICF Error Messages
ICF Experimental Features
A few features of ICF, such as comands and options, are experimental
in nature and may be discontinued in future versions. By experimental
we don't mean untested or buggy, as they undergo the same testing as
other parts of the program. It does imply that their inclusion in
future releases depends on their reported usefulness to our customers.
See Also:  ICF /Totext Option, ICF /Allext Option
ICF File Scan Operations
The FILES and PROGRAMS command perform file scan operations -
basically they scan disk drives for files. Following are the rules
outlining how these operations are carried out, illustrated with
examples. To summarize, the conventions used to specify these
operations are discussed:
-   including LAN drives in a scan
-   performing absolute scans of entire drives
-   performing relative scans starting with the default directory
-   specifying a directory
-   prevent descending of directories
-   specifying a file name
-   using * for the drive letter
By default ICF always searches all directories on all local drives. To
extend the search to LAN (remote) drives, the following options may be
used:
/Landrives      Include LAN drives
/Landriveso     Only scan LAN drives
So...
ICF FILES  /LANDRIVES
will search for all files on all drives, local and remote.
If you want to restrict the scan to an individual drive, just the
drive letter will suffice:
ICF FILES D
will search for all files on drive D:. Note that the colon is not
necessary. Not only is it not necessary, but including a colon
actually means something else! The following command:
ICF FILES D:
tells ICF to search for all files in all directories on drive D:,
STARTING with the current directory. Unlike the previous example where
the colon is ommitted and the scan starts at the root directory, using
a colon performs a "relative" search.
Of course, you can specify the directory to start with by including it
after the drive designation:
ICF PROGRAMS E:\MYPROG
will search for all programs on drive E:, starting in the \MYPROG
directory. As in the previous examples, nested directories are scanned
as well. To prevent directories from being "descended", use the
/Nodescend option:
ICF PROGRAMS C:\DOS  /NODESCEND
Finally, let's look at specifying individual files to search for.
Unlike normal DOS conventions, simply listing a file name does
something slightly different from what you might expect:
ICF FILES F:\TEST
This command will not search for a file called TEST, but rather for
any file with the string "TEST" in it. In DOS terms, it is equivalent
to "*TEST*.*" (ignoring the fact that DOS will ignore the second *).
This convention makes it easy to search for files.
There are probably times, however, where you will want to use the
standard DOS convention of specifying file names. The /Dosearch option
will accomplish this. The command
ICF FILES F:\TEST /DOSEARCH
will scan only for the file "TEST" in all directories on drive F:,
starting in the root directory. If you want to search all drives
(local drives by default), replace the drive letter with a "*":
ICF FILES *:\TEST
will scan for all files containing "TEST" in the file name, on all
drives and in all directories.
In the special (and probably rare) case where you want to find a file
that is precisely one letter long, the following won't work:
since it will scan all files on drive D:, and not for a file called
"D". If the latter is what you want, use the /Colon option:
ICF FILES D /COLON
tells ICF not to use the special "no colon means entire drive"
convention and search for a file called "D".
Making options permanent
If you want any of the options shown above to be the default
behaviour, simply include the options in the ICF environment variable,
or the ICF.INI file.
See Also:  ICF /Nodescend Option, ICF /Landrives Option, ICF
/Landriveso Option, ICF Files Command, ICF Programs Command, ICF
Environment Variables, ICF ICF.INI File, ICF /Nofilesdefault Option
ICF Files Command
The syntax of this command is:
ICF FILES <filespec1> <filespec2> <filespecn...>  /<option1>...
This command searches for files on the computer's disk drives. By
default all local drives are searched. For example,
will search for all files in all directories on all local drives. If
either the /Dbase, /Ascii, or /Lotus options is given then output is
directed to a file. Refer to "ICF Output File Structures" for
information on the file structure. If none of the above options are
used, a directory listing is displayed on the screen.
There are many options and important rules ICF follows when searching
for files, and some of them are different from normal DOS conventions.
Refer to "ICF File Scan Operations" for details.
If output is displayed on the screen, the following
ICF Help Command
ICF HELP <help topic text>
This command instructs ICF to display text related to the topic
specified on the command line. If no text is included after the HELP
command, a list of all available topics is listed. If text is
included, only those topics that contain the text are displayed, along
with the full help text for each topic.
The files ICFHELP1.DBF and ICFHELP2.DBF must be present for this
command to function. ICF expects to find them in the current
directory, unless the /Indir option is used.
To include topic text with embedded spaces, use the "_" (underscore)
character in place of each space. ICF will translate these to spaces
automatically. If for some reason you wish to use a different
character, use the /Spacechar option.
See Also:  ICF Commands Summary, ICF /Indir Option, ICF /Spacechar
ICF Hints
Following are some hints at performing tasks using ICF.
If you...
Want to send output files to a LAN drive, you may want to...
Use the /Filename option to assign a unique name to each output
file. For example:
ICF STATUS /FILENAME=$COMPID /ASCII
would analyze the computer configuration and output the
data to a file called xxxxxxx.ASC in the Ascii delimited
format. The "xxxxxxxx" is replaced with the first 8
characters from the Computer ID, assuming one is specified
by the /Computerid Option.
Use the /ID option to assign each record to the configuration it
belongs to. For example:
ICF PROGRAMS /ID /DBASE /APPEND
would search for and identify programs/software on all
drives, and each output record written would include a
field specifying the computer ID (assuming one was given
by the /Computerid option).
Want to find a file you lost...
Use the FILES command, possibly with the /Landrives option to
include remote drives in the search. For example:
ICF FILES BUDGET /LANDRIVES
will search for all files that have "BUDGET" anywhere in the
name (DOS equivalent would be "*BUDGET*.*"), and can have any
extension, on all drives, including remote drives.
See Also:  ICF Overview
ICF ICF.INI File
ICF ID Fields
In order to accomodate the automatic capture of inventory information
that is not a physical part of the computer, ICF provides a number of
special "ID" fields. These are specified using the appropriate option
and any value as a parameter to the option.  The options are only
valid for the Status command. Like any other option, these can be
issued on the command line, stored in a batch file, environment
variable, or ICF.INI file.
The syntax for each option is:
/<option name>=<string>
/Printerid=Laserjet
/Computername=JimsPC
/Modemid=Hayes1200
Whenever one of these options is given, ICF will include it's field
identifier and the value in the output file when the Status command is
performed. Refer to the "ICF Output File Structures" to see what field
identifiers are associated with each option.
Following is a brief list of the available fields.
Computerid
Miscid1
Miscid2
Modemid
Monitorid
Printerid
Userid
Username
Computername
Companyname
/Companyname Option, ICF /Printerid Option
ICF Installation
ICF can be installed in the Autoexec.Bat file, or it can be placed in
the login script of the Network Operating System.
ICF Options Specification Methods
Options can be specified to ICF using any combination of the
following. The cumulative effect of using more than one technique in a
given ICF run is then discussed.
Command Line
Options can be included with the ICF command on the DOS (or OS/2)
command line. The / or - character should be used as a prefix for
the options, as shown in the following example:
ICF STATUS /ALLDRIVES
As many options that can fit on the command line may be included.
Environment Variable
Options can be included in the special environment variable
called, appropriately enough, "ICF". The DOS or OS/2 SET command
is used to create the environment variable:
SET ICF=/ALLDRIVES
The ICF program will look for this variable and, if found, will
read in all options specified.
Note: Any options that require a value should use the : character
to separate the value from the option, as in:
SET ICF=/DRIVES:CD
If the = character is used, the SET command will produce an error
message and the SET command will be ignored.
In a File     (see note below)
Finally, ICF options can be specifed in a file called ICF.INI. If
this file exists when ICF starts, options will be read in from the
file and processed. Options should be specified one per line. A /
or - prefix is neither required nor recommended.
This file may be located in any of several places. ICF will search
each place and cumulatively process any ICF.INI files it finds:
-   In a directory called /ICF on any LAN drive
ICF will search all LAN drives for a directory named /ICF. If
found, any files called ICF.INI are processed.
-   In a directory specified by the ICFINI environment variable
-   In the current directory of the local computer
NOTE: Processing of ICF.INI files can be specifically controlled
by using the ICFINI environment variable. Refer to the 'ICF
Environment Variable "ICFINI"' Help Topic for more information.
Cumulative Process Effects
Since options may be specifed using a combination of the above
methods, they can override other previously specified options. ICF
processes options in the following order:
1.  Any LAN-based ICF.INI files
2.  Any ICF.INI files specified by the ICFINI environment variable
3.  Options specified in the ICF environment variable
4.  Options specified on the command line
See Also:  ICF Environment Variables, ICF Environment Variable
"ICFINI"
ICF Options Summary
Following is a summary of all the options for ICF.
File Scan Operations
Bigfiles        Include only big files
Bigfilesize     Specify size used for above
Size            Criteria to use for comparing file sizes
Smallfiles      Include only small files
Smallfilesize   Specify size used for above
Drives
Skipdrives
Landrives
Landriveso
Alldisks
Entiredisks
Files Command Options
Showdir         Show file directory entries
Noshowdir       Do not show file directory entries
Sizek           Display file sizes in Kilobyte units
Totext
Allext
Noalignext
Output File Type Options
Filetype        Specifies the output file type
Dbase           Output file is in Dbase III format
Ascii           Output file is Ascii format
Lotus           Output file is Lotus format
Overwrite
Append
Outdir
Outdirnov
Filename
Global Display Options
Cls             Clears the screen
Testing Options
Recslimit       Specifies maximum number of records processed
Recsnotify      Progress messages should be issued
Shortcut Options
Floppy          Specifies the /Outdir, /Needspace, and /Filename
options
Forceglobal     Specifies the /Entiredisk and /Alldisks options
Batch
LAN Options
Servers         Specify server names to process
Servertypes     Include only those servers with specified type
Domains         Only search specific domains
Status Command Options
Nonumber        Supresses line numbers from text file output
ID Options
Compid
Startup Options
Needspace
Needdir
Needfile
See Also:  ICF Options Specification Methods
ICF OS/2 Version
ICF is available in an OS/2 version that runs on OS/2 1.1, 1.2, 1.3
and 2.0. The name of the executable is ICFOS2.EXE.
See Also:  ICF /Ismca Option
ICF Output File Naming
ICF sends output to a file when one of the following options is
specified:
/Dbase      output is stored in Dbase format
/Lotus      output is stored in Lotus 1-2-3 format
/Ascii      output is stored in Ascii format
The name of the output file is normally a standard extension, which
depends on which output file format is used, and a standard name,
which depends on the ICF command being performed. Below is a list of
the standard extensions used. These cannot be changed:
/Dbase  results in .DBF
/Lotus  results in .WK1
/Ascii  results in .ASC
The standard names are shown below, controlled by what ICF command is
performed (where .ext is one of the standard extensions):
Command             Filename
=================================
STATUS or AUTO      ICFPROG.ext
FILES               ICFFILES.ext
PROGRAMS            ICFPROG.ext
Changing the file name
The /Filename option can be used to change the standard file name
assigned to the output file. This may desired for any of the following
reasons:
-   It is advantageous to identify the file with the user
identification.
-   Output files are stored on a LAN (remote) drive.
Note that in the latter case, if the filename wasn't specified with
the /Filename option then
ICF /Outdir Option, ICF /Computerid Option, ICF /Userid Option, ICF
/Username Option, ICF /Filename Option
ICF Output File Structures
When output is directed to a file for an ICF command, the output file
will have a different structure depending on the command. Following is
a summary of the file structures. The first column shows the  field
name, the second column the data type, and the third column the
length. Numeric fields have no decimal places unless otherwise
indicated. The data types are:
C - character
D - date
N - numeric
Note that output files created using the /Ascii option do not have a
structure; the structures given indicate the order of the fields
output.
FILES command
Drive       C   3
Dirname     C   60
Filename    C   8
Ext         C   3
Attrs       C   6
Size        N   12
Date        D   8
Time        C   6
Server      C   30      (valid for special ICF LAN versions only)
STATUS Command
Id          N   6
Value       C   150
Desc        C   30      (this field only output if /Desc option
given)
PROGRAMS Command
Progno      N   6
Progname    C   70
Filename    C   15
Path        C   100
Additional fields
Note: Additional fields may be automatically added to each record if
the /Id and/or /Timestamp options are specified. Refer to those option
help topics for more information.
See Also:  ICF Status Command Output File Structure, ICF /Id Option,
ICF Output File Types
ICF Overview
ICF is the Inventory Capture Facility. It is a very powerful and
flexible program that searches for, and collects, data on a variety of
computer system elements. Some of its capabilities include:
*   It is available for DOS and OS/2 operating systems. No matter who
wins the great operating system wars, you know what's on your
*   It can search and list for files on all drives, local and remote,
and use any number of filtering options when searching, including
file attributes, size, name, etc.
*   It can search and report for all software packages, including both
predefined packages as well as custom software. The database for
predefined software is user-defined, allowing new programs to be
added. ICF can also, upon request, capture all software programs
regardless of whether or not they have been defined.
*   On microchannel computers it can report on all boards installed.
*   It can analyze and report on system parameters, including DOS
version, name, memory (normal, extended, expanded), CMOS data,
mouse information, etc.
*   It can record physical or stand-along components that cannot
automatically be recognized.
*   It can completely automate the collection of data discussed above
and save information on shared LAN drives.
*   It can run standalone and store data files on floppy disks.
*   It can gather network (LAN) information.
*   It can perform a quick "pre-check" to determine whether or not
changes have actually been made to the configuration of a PC, and
then decide to perform a full configuration data collection!
*   It is easy to use, command-line driven, and flexible with hundreds
of options to fine-tune operation.
See Also:  ICF Command Syntax
ICF Program
See Also:  Import Configuration Defaults
ICF Programs Command
ICF PROGRAMS <filespec1> <filespec2> <filespecn...>  /<option1>...
ICF Shortcut Options
Shortcut Options are options that do nothing more than specify other
options. They may be useful because they serve to automatically adjust
ICF processing for certain tasks without specifying individual options
repeatedly.
Following are the shortcut options available in ICF.
/Floppy
/Batch
/Forceglobal
See Also:  ICF /Floppy Option, ICF /Batch Option, ICF /Forceglobal
ICF Status Command
Status <status subject list>
This command command collects information describing the configuration
of the PC and either displays the information on the screen or sends
it to an output file. If no filetype option is given then the
configuration is displayed on the screen, and may be redirected to a
text file or printer using DOS redirection techniques.  A sample
report is shown below (An OS/2 system was used - output format is
similar to DOS systems):
===================================================================
ID INFORMATION
-------------------------------------------------------------------
User ID :  SMITH
Computer ID :  1232,1321
Notes 1 :  TAKEN BY JOE
Notes 2 :  BUILDING 8
Location :  ROOM 128
MAIN INFORMATION
Date :  02/02/91
Time :  23:49:51
Processor :  386
Coprocessor (Bios) :  NO
PC Model code :  01FC
PC Model name :  PC-AT 3x9 or clone
Serial ports :  2
Printer ports :  1
Floppy drives :  2
Local drives :  ABCDE
OS version :  OS/2  1.30
VIDEO INFORMATION
Video adapter :  1
Video display :  8514
Video adapter name :  VGA
CMOS INFORMATION
Floppy 1 :  3.5 1.44M
Floppy 2 :  5.25 1.2M
Hard drive 1 type :  47
Base Memory :  640
Expanded Memory :  7168
PROGRAM INFORMATION
1. DOS PROGRAM ........................ C:\COMMAND.COM
2. IBM DOS ............................ C:\IBMDOS.COM
3. (No Name) .......................... C:\MANIFEST.EXE
4. MS-DOS ............................. C:\DOS\FDISK.EXE
5. DOS PROGRAM ........................ C:\DOS\COMMAND.COM
6. DOS PROGRAM ........................ C:\OS2\COMMAND.COM
7. OS/2 PROGRAM ....................... C:\OS2\SPOOL.EXE
8. MAGELLAN 1.0 ....................... D:\MAG\MAGINDEX.EXE
9. WINDOWS FOR WORD ................... D:\PMWORD\TECHREF.DOC
10. MANAGING YOUR MONEY PROGRAM ........ D:\MYM8\MYM.EXE
11. MICROSOFT C COMPILER ............... D:\C600\BINP\C1L.EXE
ENVIRONMENT VARIABLE INFORMATION
COMSPEC=C:\OS2\CMD.EXE
DPATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\INSTALL;C:\;
HELP=C:\OS2\HELP;
KEYS=ON
BOOKSHELF=C:\OS2\BOOK;
DRIVE INFORMATION
C:    33,296,384     24,782,848   (0.0)         8,513,536   (0.0)
D:    88,485,888     87,330,816   (0.0)         1,155,072   (0.0)
E:    88,485,888     69,390,336   (0.0)        19,095,552   (0.0)
==================================================================
SYSTEM CONFIGURATION FILE INFORMATION
------------------------------------------------------------------
******** [ CONFIG.SYS File ] ********
1. C:\PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI C:\OS2\OS2SYS.INI
C:\OS2\CMD.EXE
2. C:\SET COMSPEC=C:\OS2\CMD.EXE
3. C:\LIBPATH=C:\OS2\DLL;C:\
4. C:\SET TEST=YES
5. C:\SET DPATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\INSTALL;C:\;
6. C:\SET PROMPT=$i[$p]
7. C:\SET HELP=C:\OS2\HELP;
8. C:\BUFFERS=60
9. C:\IOPL=YES
10. C:\DISKCACHE=2048
11. C:\MAXWAIT=3
12. C:\MEMMAN=SWAP,MOVE,SWAPDOS
13. C:\PROTECTONLY=NO
14. C:\SWAPPATH=C:\OS2\SYSTEM 512
.
If the /Dbase, /Lotus, or /Ascii options are given then the output is
directed to a file. The format of the output file structure is given
in the "ICF Status Command Output File Structure" Help Topic.
ICF STATUS
Displays on the screen the configuration of the PC.
ICF STATUS /DBASE
Redirects the configuration data to an output file in the
Dbase format.
ICF STATUS MCA PRO
Performs the status command but only collects information
concerning microchannel boards (MCA) and programs (PRO). The
list of all categories that can be included here is shown
below:
MCA     Micrchannel
MEM     Memory
MOU     Mouse
VIO     Video
MAI     Main information
PRO     Program (software) information
LAN     LAN Information
ENV     Environment variables
IDI     Id information
DSK     Disk information
TXT     Text files (i.e. Config.sys, Autoexec.bat)
CMO     Cmos information
SUB     DOS TSR and Subsystem information
Options
Many options can be used with the Status command. Specific ones that
may be useful include:
/Nostatus
Means "don't perform status on selected categories of
information". The categories are shown above and given as a
parameter to the option, as shown in the following example:
ICF STATUS /NST=PRO
This tells ICF to skip collecting information for programs, which
can be useful since it bypasses what could be a timely disk scan.
See Also:  ICF Status Command Output File Structure, ICF /Nostatus
ICF Status Command Output File Structure
The structure of the output file when the Status command is used to
collect PC inventory information is shown below:
The Id field holds a number representing used to identify the type of
information in the record. For example, the operating system name and
version are two different types of information and each has a specific
Id assigned.
The Value field contains the actual string representing the value of
the data item being collected. Any numeric values are always converted
to character format prior to storing them in this field.
The Desc field is only included in the output file structure if the
/Desc option is given. If specified, this field contains a description
of the data item stored in the record.
The purpose of all this is to have a uniform data structure for
collecting disparate forms of data. If you write programs to read the
files created by the ICF Status command, you can easily read the file
and simply use lookup tables to refer to what data each record
contains. Following is a list of the different ID numbers assigned to
each data item. Items followed by (#) have special notes given below:
ID Description                  ID #    Data type
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
Total expanded memory           1       number
Expanded memory page frame      2       hex
Available expanded memory       3       number
Expanded memory version         4       number
Mouse type                      5       string
Mouse driver version            6       number
Mouse IRQ                       7       number
Total extended memory           8       number
Available memory                9       number
Used memory                     10      number
Reported memory                 11      number
Video adapter                   12      string
Video display                   13      string
Video adapter name              14      string
Processor                       17      string
CoProcessor                     18      string
PC Model code                   19      hex
PC Model name                   20      string
Number of serial ports          21      number
Number of parallel ports        22      number
Number of floppy drives         23      number
Verify mode                     24      string
Drives                          25      string
Operating System version        26      string
Bios                            27      string
Username ID                     28      string
Computer ID                     29      string
Company name                    30      string
DOS Print TSR                   31      string
DOS Append TSR                  32      string
Program                         33      packed (1)
Microchannel board              34      packed (2)
Logical disk information        35      packed (3)
Environment variable            54      string
Printer ID                      55      string
Modem ID                        56      string
Monitor ID                      57      string
User ID                         58      string
Misc ID 1                       59      string
Misc ID 2                       60      string
Location                        68      string
Bus type                        61      string
Current date                    63      date
Current time                    64      string
Text file                       70      string (4)
Notes 1                         66      string
Notes 2                         67      string
Cmos floppy 1 type              1001    string
Cmos floppy 2 type              1002    string
Cmos hard drive 1 type          1003    number
Cmos hard drive 2 type          1004    number
Cmos base memory                1005    number
Cmos expanded memory            1006    number
Cmos math coprocessor           1007    string
NOTES
Packed values - Some fields have values that are actually a
concatenation of strings. The fields that use this method have a data
type of "packed" and their contents are described below. Each string
in a packed field is separated from the next by a "token character".
By default this character is the caret "^".
(1) Programs
The value returned for each program found includes the following
concatenated fields:
1.  Product number -        number obtained from the ICF input
file (if one was present) It will be
zero otherwise. This number makes it
easy to identify common software.
2.  Path and file name
3.  Program description -   comes from the ICF input file.
The following items are only appended if the /Proginfo option is
specified.
4.  File size
5.  File date
6.  File time
(2) Microchannel board
The value returned for a microchannel board includes the following
2.  Microchannel ID code -  read from the board itself
3.  Board description -     comes from the ICF input file.
(3) Logical disk information
1.  Drive number (3=C, 4=D, etc...)
2.  Total disk space
3.  Free disk space
4.  Used disk space
(4) Text files
Text files return the lines from various configuration files.
These include Config.Sys and Autoexec.Bat. The value returned for
a text file includes the following concatenated fields:
1.  File name
2.  File path
3.  Text of line
Every line from the text file is returned in succession as a
separate record in the ICF output file.
See Also:  ICF Status Command, ICF /Desc Option
ICF Using Options
ICF /Ringbell Option
This option instructs ICF to ring the bell when the current command is
complete. It is useful when running long commands or batch files and
you want to know when it has finished.